home *** CD-ROM | disk | FTP | other *** search
/ The Best Shareware of the Year 1997 Winter / The Best Shareware of the Year 1997 Winter.iso / software / superior / best / update / vuesetup.exe / DDEDOC.TXT < prev    next >
Encoding:
Text File  |  1996-06-14  |  5.0 KB  |  119 lines
  1. VistaVue 4.0 DDE Commands
  2.  
  3. Application : VISTA
  4. Topic: SYSTEM
  5. Topic Item: VISTACMD
  6. Topic Item: VISTADATA
  7.  
  8.  
  9. For most commands, theVISTACMD and the VISTADATA topic items are used as a team.  The VISTACMD must always be sent first, followed by the VISTADATA command that usually passes a filename or parameter to VistaVue.
  10.  
  11.  
  12. Note: All examples are shown in MS Access code format:
  13. Note: A program called VistaVue 4.0 DDE Experimenter is included that can be used as a tool for testing and trying the following DDE commands on VistaVue.  More information on this program is included at the end of this document.
  14.  
  15.  
  16. Initiate Contact with VistaVue:
  17.  
  18. Dim Chan, I   ' Declare variables.
  19.     On Error Resume Next
  20.     Chan = DDEInitiate("VISTA", "System")   ' Establish  link.
  21.     If Err Then             ' If error occurs, VistaVue
  22.         Err = 0                 ' isn't running. Reset error
  23.         I = Shell("c:\vista\vista.exe ", 1)   ' and start VistaVue
  24.         If Err Then Exit Sub    ' If another error, exit.
  25.         Chan = DDEInitiate("VISTA", "System")   ' Establish  link.
  26.     End If
  27.  
  28.  
  29. LoadFile    Loads a file into VistaVue, picks the first open window available
  30. LoadFile1    Loads a file into VistaVue directly into Window #1
  31. LoadFile2    Loads a file into VistaVue directly into Window #2
  32. LoadFile3    Loads a file into VistaVue directly into Window #3
  33. LoadFile4    Loads a file into VistaVue directly into Window #4
  34.  
  35.     Syntax:  1. Send LOADFILE via Topic Item: VISTACMD
  36.         2. Send Filename via Topic Item: VISTADATA
  37.  
  38. TopicList = DDERequest(Chan, "VistaCmd")   'Send Profile command to VistaVue.
  39.     DDEPoke Chan, "VistaCmd", "LOADFILE"
  40.     TopicList = DDERequest(Chan, "VistaData")   'Send full filename with volume and path
  41.     DDEPoke Chan, "VistaData", "C:\mydir\myfile.jpg"
  42.  
  43.  
  44.  
  45. maximize    Maximizes VistaVue back from minimized state
  46. minimize    Minimizes VistaVue, stores window setting
  47.     Syntax:  1. Send maximize or ,inimize via Topic Item: 
  48.             VISTACMD (VISTADATA is not used)
  49.  
  50.  
  51. OffMain        Resets main window back to current profile format
  52. OffWin1    Resets Image window #1 back to current profile format
  53. OffWin2    Resets Image window #2 back to current profile format
  54. OffWin3    Resets Image window #3 back to current profile format
  55. OffWin4    Resets Image window #4 back to current profile format
  56.  
  57.     Syntax:  1. Send Offmain via Topic Item: VISTACMD    (VISTADATA is not used)
  58.  
  59.  
  60. Print        Sends a image to the printer in its original size (automatic, no user dialog).
  61. Print2Fit     Sends a image to the printer Fit to Page (automatic, no user dialog).
  62.         Note: The above print commands automatically print all pages of a file (DCX,TIFF).
  63.         Note: When printing a multi-page image, a page is ejected before the session
  64.  
  65.     Syntax:  1. Send PRINT via Topic Item: VISTACMD
  66.         2. Send Filename via Topic Item: VISTADATA
  67.  
  68.  
  69. Profile        Loads one of 10 user defined profiles into memory.
  70.         Profile names are: Vista0.dat (Default), Vista1.dat to Vista9.dat
  71.  
  72.     Syntax:  1. Send PROFILE via Topic Item: VISTACMD
  73.         2. Send Filename via Topic Item: VISTADATA
  74.  
  75.  
  76. SetMain        Set the Main Windows upper X & Y position, width & height
  77. SetWin1        Set Image Window #1 upper X & Y position, width & height
  78. SetWin2        Set Image Window #1 upper X & Y position, width & height
  79. SetWin3        Set Image Window #1 upper X & Y position, width & height
  80. SetWin4        Set Image Window #1 upper X & Y position, width & height
  81.  
  82.     Syntax:  1. Send SETWIN1 via Topic Item: VISTACMD
  83.         2. Send  x, y, width, height   (all units in screen pixels, seperated by comma's)
  84.         i.e. 10,10,300,300    (Minimum height and width are 10 pixels)
  85.  
  86.  
  87. TbarFile        Turn on or off the File Toolbar  (VISTADATA : 0 = on, 1 = 0ff)
  88. TbarView    Turn on or off the View Toolbar  (VISTADATA : 0 = on, 1 = 0ff)
  89. TbarEdit    Turn on or off the Edit Toolbar  (VISTADATA : 0 = on, 1 = 0ff)
  90.  
  91.     Syntax:  1. Send TBARFILE via Topic Item: VISTACMD
  92.         2. Send  0 to turn on the toolbar, 1 to turn off
  93.  
  94.  
  95. ShutDown    Terminates VistaVue without saving changes or modifications to the profile file.
  96.  
  97.     Syntax:  1. Send SHUTDOWN via Topic Item: VISTACMD (VISTADATA is not used)
  98.  
  99.  
  100.  
  101. VistaVue 4.0 DDE Experimenter:
  102.  
  103. The Experimenter program includes all available DDE commands loaded into the pull down menu.  Before sending a command you must have VistaVue loaded in memory.  If you would like to start VistaVue in a minimized state, regardless of any profiles then pressing the "Load VistaVue" button issues the following:
  104.  
  105. ie. C:\Vista\Vista.exe /DDE    The /DDE after Vista.exe causes VistaVue to load and minimize.
  106.  
  107. Once you select a command, press OK.  A new dialog will appear with the VISTACMD located at the top and for most commands a blank entry for the VISTADATA.  Enter your data string on the VISTADATA line and press POKE to send all DDE commands to VistaVue.
  108.  
  109.  
  110.  
  111.  
  112. DDE REQUEST COMMANDS:
  113.  
  114. - applications can now retrieve the filename(via DDE) of a VistaVue window.
  115.    Window #1    VistaWIN1
  116.    Window #2    VistaWIN2
  117.    Window #3    VistaWIN3
  118.    Window #4    VistaWIN4
  119.    The VistaWIN(#) variable can be read by using the DDE request command.